home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / latex209 / contrib / psfrag / ps2psfrag / README < prev    next >
Text File  |  1992-09-13  |  2KB  |  53 lines
  1. Description:
  2.  
  3. * PsFrag is a set of LaTeX macros for overlaying postscript figures with
  4.   fragments of LaTeX.  More precisely, the PsFrag macros allow specific
  5.   pieces of postscript text in a postscript figure (included via \epsfbox
  6.   or \special) to be replaced with arbitrary fragments of LaTeX.  When
  7.   your document is latex'ed and dvips'ed, each piece of postscript text
  8.   is replaced by the LaTeX text.
  9.   
  10.   The postscript file might be produced, for example, by xfig, idraw,
  11.   matlab, xmath, etc.  Each string displayed by postscript's show operator
  12.   is a candidate for replacement by LaTeX text, math symbols, equations,
  13.   pictures etc.  For example, you can include a matlab plot in a LaTeX
  14.   document with the title, axis labels, and legend generated by LaTeX.
  15.  
  16.   The LaTeX fragments can be optionally rotated, scaled, and repositioned
  17.   relative to the text being replaced.  The LaTeX fragments automatically
  18.   track the postscript text position as the postscript file is modified,
  19.   or as the scaling and offsets of the \special or \epsfbox are changed.
  20.  
  21. * PsFrag consists of four files:
  22.  
  23.   - epsf.sty: a slightly modified version of the original epsf.tex that
  24.     supports PsFrag.  It's upward compatible with the old version, so
  25.     it should work just the same when used without PsFrag.
  26.  
  27.   - psfrag.sty: contains the psfrag macros.
  28.  
  29.   - ps2psfrag: a shell script that uses ghostscript to find out the position,
  30.     orientation and content of each piece of text that a particular postscript
  31.     file displays (shows).  This has to be run once for each postscript
  32.     figure.
  33.  
  34.   - ps2psfrag.ps: a postscript file used by ps2psfrag.
  35.  
  36. * PsFrag is available via anonymous ftp from isl.stanford.edu (internet
  37.   address 36.60.0.10).  After logging in, cd to the directory pub/boyd/psfrag,
  38.   and set binary mode.  Get the compressed tar file psfrag.tar.Z, uncompress
  39.   it, and tar xvf it:
  40.  
  41.     uncompress psfrag.tar.Z
  42.     tar xvf psfrag.tar
  43.  
  44.   See the files README, USAGE, INSTALL for detailed information.
  45.  
  46. * Note: PsFrag uses ghostscript (gs) from the gnu distribution, and assumes
  47.   that your dvi to ps driver is dvips from Radical Eye Software (which is
  48.   widely available at many TeX installations).  Other dvi to postscript
  49.   drivers will *not* work.  Do yourself a favor and get/use dvips.
  50.  
  51. Craig Barratt, Sun Feb 29 23:29:05 PST 1992
  52. craig@isl.stanford.edu
  53.